home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / compress / zface72.zip / ZFMANUAL.DOC < prev    next >
Text File  |  1993-06-05  |  22KB  |  642 lines
  1.     
  2.     
  3.     
  4.     
  5.     
  6.     
  7.                                   ZFace
  8.     
  9.               The easy way to use file archiving programs.
  10.     
  11.                    Version .72 Revised June 5, 1993
  12.     
  13.     
  14.     
  15.     
  16.     
  17.     
  18.     
  19.                             _______
  20.                        ____|__     |               (tm)
  21.                     --|       |    |-------------------
  22.                       |   ____|__  |  Association of
  23.                       |  |       |_|  Shareware
  24.                       |__|   o   |    Professionals
  25.                     -----|   |   |---------------------
  26.                          |___|___|    MEMBER
  27.     
  28.     
  29.     
  30.     
  31.     
  32.     
  33.     
  34.                     Copyright 1991 by Stanley N. May
  35.                            All rights reserved
  36.     
  37.     
  38.     
  39.     
  40.     
  41.     
  42.     ─────────────────────────────────────────────────────────────────
  43.     
  44.                                DISCLAIMER
  45.     
  46.     Users of ZFace must accept this disclaimer of warranty:
  47.     
  48.     "ZFace is supplied as is. ZFace carries NO warranty either
  49.     express or implied. The person using ZFace bears all risk as to
  50.     the quality and performance of the software. The author assumes
  51.     no liability for damages, direct or consequential, which may
  52.     result from the use of ZFace."
  53.      ─────────────────────────────────────────────────────────────────
  54.     
  55.                             TABLE of CONTENTS
  56.     
  57.     Definition of Shareware....................................1
  58.     License and Agreement......................................2
  59.     Ombudsman Statement........................................3
  60.     Support....................................................3
  61.     Introduction...............................................4
  62.     Requirements...............................................5
  63.     Getting Started............................................5
  64.     Drive and Directory Selection..............................6
  65.     File List Windows..........................................6
  66.     Zip........................................................6
  67.     Unzip......................................................8
  68.     View and Zip─to─EXE........................................9
  69.     Results....................................................9
  70.     Registration Form.........................................10
  71.     
  72.     
  73.     ─────────────────────────────────────────────────────────────────
  74.     
  75.                        DEFINITION OF SHAREWARE
  76.     
  77.     Shareware distribution gives users a chance to try software
  78.     before buying it. If you try a Shareware program and continue
  79.     using it, you are expected to register. Individual programs
  80.     differ on details ── some request registration while others
  81.     require it, some specify a maximum trial period. ZFace requires
  82.     registration within 30 days of first use.
  83.     
  84.     Copyright laws apply to both Shareware and commercial software,
  85.     and the copyright holder retains all rights, with a few specific
  86.     exceptions as stated below. Shareware authors are accomplished
  87.     programmers, just like commercial authors, and the programs are
  88.     of comparable quality. (In both cases, there are good programs
  89.     and bad ones!) The main difference is in the method of
  90.     distribution. The author specifically grants the right to copy
  91.     and distribute the software, either to all and sundry or to a
  92.     specific group. For example, some authors require written
  93.     permission before a commercial disk vendor may copy their
  94.     Shareware.
  95.     
  96.     Shareware is a distribution method, not a type of software. You
  97.     should find software that suits your needs and pocketbook,
  98.     whether it's commercial or Shareware. The Shareware system makes
  99.     fitting your needs easier, because you can try before you buy.
  100.     And because the overhead is low, prices are low also. Shareware
  101.     has the ultimate money─back guarantee ── if you don't use the
  102.     product, you don't pay for it.
  103.     
  104.     
  105.     
  106.     
  107.     
  108.                                     - 1 -
  109.     
  110.     ─────────────────────────────────────────────────────────────────
  111.     
  112.                         LICENSE AND AGREEMENT
  113.     
  114.     ZFace is a "shareware program" and is provided at no charge to
  115.     the user for evaluation. You may copy and distribute the program
  116.     to whoever you wish provided that the disk or archive file
  117.     containing ZFace contains all the files and nothing but the
  118.     files. To distribute a copy of ZFace as part of a compilation or
  119.     with some other software package or text file, you must first
  120.     contact the author at the address or phone numbers listed below
  121.     for permission.
  122.     
  123.     The essence of "user─supported" software is to provide personal
  124.     computer users with quality software without high prices, and yet
  125.     to provide incentive for programmers to continue to develop new
  126.     products. If you find this program useful and find that you are
  127.     using ZFace after a 30 day trial period, you must make a
  128.     registration payment of $25.00. A registration form can be found
  129.     at the end of this manual.
  130.     
  131.     The $25.00 registration fee will license one copy for use on any
  132.     one computer at any one time. You must treat the registered
  133.     version of this software just like a book. An example is that
  134.     this software may be used by any number of people and may be
  135.     freely moved from one computer location to another, so long as
  136.     there is no possibility of it being used at one location while
  137.     it's being used at another. Just as a book cannot be read by two
  138.     different persons at the same time. Site licenses and other
  139.     multiuser arrangements may be made by contacting the author.
  140.     
  141.     Users of ZFace must register and pay for their copies of the
  142.     program within 30 days of first use or their license to use ZFace
  143.     is withdrawn.
  144.     
  145.     When you register ZFace you will receive:
  146.     
  147.       * Notification of upgrades
  148.       * Unlimited technical support
  149.       * Acknowledgment and Thanks for your support and encouragement.
  150.     
  151.     Anyone distributing ZFace for any kind of remuneration must first
  152.     contact the author at the address below for authorization. This
  153.     authorization will be automatically granted to ASP approved
  154.     vendors. However, the author must still be advised so that the
  155.     distributor can be kept up─to─date with the latest version of
  156.     ZFace.
  157.     
  158.     
  159.     
  160.     
  161.     
  162.     
  163.  
  164.  
  165.  
  166.  
  167.                                     - 2 -
  168.     
  169.     ─────────────────────────────────────────────────────────────────
  170.     OMBUDSMAN STATEMENT
  171.     
  172.     "This program is produced by a member of the Association of
  173.     Shareware Professionals (ASP). ASP wants to make sure that the
  174.     shareware principle works for you. If you are unable to resolve a
  175.     shareware─related problem with an ASP member by contacting the
  176.     member directly, ASP may be able to help. The ASP Ombudsman can
  177.     help you resolve a dispute or problem with an ASP member, but
  178.     does not provide technical support for members' products. Please
  179.     write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  180.     or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  181.     70007,3536."
  182.     
  183.     ─────────────────────────────────────────────────────────────────
  184.     SUPPORT
  185.     
  186.       If you need any kind of assistance with ZFace, please contact:
  187.     
  188.         Stan May
  189.         916B Kirsten Court
  190.         Rohnert Park, CA 94928
  191.     
  192.         Voice:....................(707) 585-1728
  193.         Compuserve User ID:.......72740,2076
  194.     
  195.       I'd love to hear any comments or suggestions you might have.
  196.  
  197.  
  198.     
  199.     
  200.     
  201.     
  202.     
  203.     
  204.     
  205.     
  206.     
  207.     
  208.     
  209.     
  210.     
  211.     
  212.     
  213.     
  214.     
  215.     
  216.     
  217.     
  218.     
  219.     
  220.     
  221.     
  222.     
  223.     
  224.     
  225.     
  226.     
  227.                                     - 3 -
  228.     
  229.     ─────────────────────────────────────────────────────────────────
  230.     INTRODUCTION
  231.     
  232.       File archiving programs, like PKZIP, are handy utilities for
  233.       condensing many files into one much smaller file. This makes it
  234.       fast and easy to transfer files among different users either on
  235.       floppy disks or via modems. It's easy because you only have to
  236.       deal with one file. It's fast because one smaller file will
  237.       take less time to upload or download over a modem. But there is
  238.       a downside...
  239.     
  240.       PKZIP and other file archiving programs are command line based.
  241.       That means, in order to use them, you must remember and type in
  242.       long commands and switches at the C:> prompt. If you want to
  243.       archive more than one file, you have to remember all the file
  244.       names or create a list of files the archiving program can use.
  245.       With so much software that is menu based, many users don't need
  246.       or want to learn long, typed commands and switches or create
  247.       extra file lists. A need for a menu based interface for
  248.       archiving programs is indicated.
  249.     
  250.       This is where ZFace comes in. ZFace was created as an MENU
  251.       driven interface for command line based archiving programs.
  252.       ZFace is simple to use, you just tell ZFace what you want to do
  253.       by selecting an action from a menu, then tell it what files to
  254.       work on by selecting them from a list. ZFace does the rest.
  255.     
  256.       File archiving programs, like PKZIP, usually have a myriad of
  257.       options. These options may be needed by some users but many
  258.       people only need to Zip, View and Unzip files. At this time
  259.       only PKZIP is supported. Other programs will be supported in a
  260.       future release. ZFace supports the following PKZIP options:
  261.     
  262.         Zip
  263.           Create a new .zip file.
  264.           Update existing .zip file with a newer version of a file.
  265.           Add files to an existing .zip file.
  266.           Zip directories
  267.         View
  268.           View contents of .zip file.
  269.         Unzip
  270.           Unzip all files in a .zip file.
  271.           Unzip selected files in a .zip file.
  272.           Restore zipped directories.
  273.         Zip─to─EXE *
  274.           Create a self extracting Zip file.
  275.     
  276.     * Zip─to─EXE is a PKZIP program (zip2exe.exe) that allows you to
  277.       convert an existing .zip file into a self─extracting .exe file.
  278.       The self─extracting file can be unzipped at the command line
  279.       simply by typing its name and pressing <ENTER>. The PKZIP
  280.       program is NOT required. That makes it easy to give a zipped
  281.       file to anyone, whether they have a copy of PKZIP or not.
  282.     
  283.     
  284.     
  285.     
  286.                                     - 4 -
  287.     
  288.     ─────────────────────────────────────────────────────────────────
  289.     REQUIREMENTS
  290.     
  291.     *** Users must supply their own copy of PKZIP Ver 1.10 or later ***
  292.     
  293.       ZFACE.EXE, pkzip.exe, pkunzip.exe and zip2exe.exe must reside
  294.       in the same directory.
  295.     ─────────────────────────────────────────────────────────────────
  296.     GETTING STARTED
  297.     
  298.       ZFace will present the user with a main menu bar consisting of
  299.       Zip, View, Unzip, Zip─to─EXE and Quit. The program will then
  300.       guide the user through selecting a drive and directory,
  301.       selecting files to work on and executing the selected option.
  302.       All subdirectories, files and options will be selected from a
  303.       list, menu style. After executing the PKZIP option, the program
  304.       will return to the main menu.
  305.     
  306.       Files can be zipped or unzipped from any drive or directory and
  307.       the resulting files will be placed in the same directory. Some
  308.       temporary files will also be created. They will be erased after
  309.       the option has been executed.
  310.     
  311.       At the command line, type "zface" and press <ENTER>. The main
  312.       program screen will come up. Choose a menu item by using the
  313.       arrow keys and press <ENTER>. Follow on─screen directions using
  314.       the highlighted Action Keys.
  315.     
  316.       Generally: Action Keys are GREEN on color screens and BOLD on
  317.          mono screens.
  318.     
  319.         a. Press <ENTER> after inputs, for menu selections and to
  320.            mark and unmark files.
  321.     
  322.         b. Press <ESC> to cancel or backup. Pressing it several times
  323.            will take you back to the main menu.
  324.     
  325.         c. Press <TAB> to go between the directory window and the
  326.            file list window.
  327.     
  328.         d. Press <F10> to execute an action.
  329.     
  330.         e. <PageUp>, <PageDown> and the arrow keys work as expected.
  331.     
  332.       Mouse: Only the left button is used.
  333.     
  334.         a. Click on a menu item to execute it.
  335.     
  336.         b. Click on Action Keys.
  337.     
  338.         c. Click on sub─directories and files to select or
  339.            mark/unmark.
  340.     
  341.         d. Click anywhere when you get "Press any key..."
  342.     
  343.     
  344.     
  345.                                     - 5 -
  346.     
  347.     ─────────────────────────────────────────────────────────────────
  348.     DRIVE and DIRECTORY SELECTION
  349.     
  350.       In the drive selection window, enter the drive letter: A, C, D
  351.       etc and press <ENTER>. ZFace is not case sensitive and no colon
  352.       is needed. The current path will be displayed and two windows
  353.       will pop up. One window will list sub─directories to choose
  354.       from. The other window lists the files in the current path.
  355.     
  356.       Use the <UP/DOWN> arrow keys or <PAGEUP/PAGEDOWN> to navigate
  357.         through the directory list.
  358.     
  359.       Press <ENTER> to select a directory.
  360.       Press <TAB> to go to the file list window.
  361.     
  362.       Mouse: Click on a directory to select it.
  363.              Click on an Action Key.
  364.              Clicking anywhere in the file list window is the same as
  365.                pressing <TAB>.
  366.     
  367.     ─────────────────────────────────────────────────────────────────
  368.     FILE LIST WINDOWS
  369.     
  370.       The file list window is used to select the file or files to
  371.       work on. If ZIP was selected, then all files in the working
  372.       directory will be listed. For UNZIP, VIEW and Zip─to─EXE, only
  373.       files with a .zip extension will be listed.
  374.     
  375.       Use the <UP/DOWN> arrow keys or <PAGEUP/PAGEDOWN> to navigate
  376.       through the file list.
  377.     
  378.       Press <ENTER> to select or mark/unmark files.
  379.     
  380.       Mouse: Click on an Action Key.
  381.              Click on a file to select or mark/unmark.
  382.     
  383.     ─────────────────────────────────────────────────────────────────
  384.     ZIP
  385.     
  386.       Selecting files to zip
  387.         You can either ZIP all files in a directory or you can select
  388.         only specific files.
  389.     
  390.         All files:
  391.           Press <INSERT> to mark all files.
  392.           Press <DELETE> to unmark all files.
  393.     
  394.         Specific files:
  395.           Press <ENTER> to mark or unmark individual files.
  396.     
  397.           Mouse: Click on an Action Key.
  398.                  Click on a file to mark or unmark.
  399.     
  400.     
  401.     
  402.     
  403.     
  404.                                     - 6 -
  405.     
  406.       ZIP the files
  407.         After selecting your files press <F10> to ZIP the marked
  408.         files. An option menu will be displayed. Use the <UP/DOWN>
  409.         arrow keys and press <ENTER> to select an option.
  410.     
  411.         Mouse: Click on the <F10> Action Key.
  412.                Click on an option.
  413.     
  414.         Options
  415.           Create
  416.             ZIP the marked files and place them in a new .zip file.
  417.           Add
  418.             Place the marked files in an existing .zip file and
  419.             overwrite any files with the same name.
  420.           Update
  421.             Place the marked files in an existing .zip file.
  422.             Overwrite only if file is dated later than a file with
  423.             the same name already in the .zip file.
  424.           Include sub─directories
  425.             All files in the working directory plus all files in all
  426.             sub─directories of the working directory will be zipped.
  427.             The files in the sub─directories include their pathnames
  428.             so the same directory structure can be restored when the
  429.             file is unzipped. This option will create a new file.
  430.           Quit to main menu.
  431.             "Cancel ZIP, I want to do something else."
  432.     
  433.         Filename
  434.           After selecting an option you will be prompted for a file
  435.           name.
  436.     
  437.           Create a new file
  438.             Type in a file name and press <ENTER>. The .zip extension
  439.             will be added by the program. Pressing <ENTER> with no
  440.             file name or pressing <ESC> cancels ZIP and returns to
  441.             the main menu.
  442.     
  443.           Updating or adding to existing file
  444.             A window will pop up with a list of .zip files in the
  445.             working directory.
  446.     
  447.             Press <ENTER> to select a file.
  448.             Press <F10> to update the selected file
  449.             Any other key lets you select another file.
  450.     
  451.             Mouse: Click on a file to select it.
  452.                    Click on the <F10> Action Key.
  453.                    Clicking anywhere else lets you select another
  454.                      file.
  455.     
  456.             If there are no .zip files in the working directory, you
  457.             will get the same file name window as in Create a new
  458.             file above.
  459.     
  460.       PKZIP is executed and you will see your files being zipped!
  461.     
  462.     
  463.                                     - 7 -
  464.     
  465.     ─────────────────────────────────────────────────────────────────
  466.     UNZIP
  467.     
  468.       Press <ENTER> to select a file to unzip.
  469.       Press <F10> to UNZIP.
  470.       Any other key lets you select another file.
  471.     
  472.       Mouse: Click on a file to select it.
  473.              Click on the <F10> Action Key.
  474.              Clicking anywhere else lets you select another
  475.                file.
  476.     
  477.       Next you will be asked which unzip option to use. Use the arrow
  478.       keys and press <ENTER> to select an option.
  479.     
  480.         Unzip ALL files to the working directory.
  481.           Place ALL files in the working directory, even if the .zip
  482.           file includes pathnames and a directory structure.
  483.     
  484.         SELECT individual files.
  485.           Allows you to select only specific files to unzip.
  486.     
  487.         Restore a DIRECTORY structure.
  488.           Place all files WITHOUT a pathname in the working directory
  489.           and the rest will be put in the proper sub─directory under
  490.           the working directory.
  491.           Sub─directories will be created under the working directory
  492.           if they don't already exist.
  493.     
  494.         ** CAUTION **
  495.           Make sure your .zip file is where you want it before you
  496.           unzip it.
  497.     
  498.         Mouse: Click on a menu item.
  499.     
  500.       Unzip all & restore directory
  501.         Done, watch 'em unzip!
  502.     
  503.       Selecting individual files
  504.         Press <ENTER> to mark and unmark files.
  505.         Press <F10> to unzip the marked files.
  506.     
  507.         Mouse: Click on a file to mark or unmark.
  508.                Click on an Action Key.
  509.     
  510.       Your files get unzipped!
  511.     
  512.     
  513.     
  514.     
  515.     
  516.     
  517.     
  518.     
  519.     
  520.     
  521.     
  522.                                     - 8 -
  523.     
  524.     ─────────────────────────────────────────────────────────────────
  525.     VIEW and Zip─to─EXE
  526.     
  527.       Press <ENTER> to select a file.
  528.       Press <F10> to execute the action.
  529.       Any other key lets you select another file.
  530.     
  531.       Mouse: Click on a file to select it.
  532.              Click on the <F10> Action Key.
  533.              Clicking anywhere else lets you select another
  534.                file.
  535.     
  536.       The action is executed while you watch!
  537.     
  538.     ─────────────────────────────────────────────────────────────────
  539.     RESULTS
  540.     
  541.       All files resulting from the action taken will be saved to the
  542.       "working" directory. The working directory is the directory
  543.       containing the files you are "working" on.
  544.     
  545.       ZIP example:
  546.         Working directory.........c:\lotus\spread
  547.         Zip file name.............123sprd
  548.         Will result in............c:\lotus\spread\123sprd.zip
  549.     
  550.       UNZIP example:
  551.         Working directory.........c:\lotus\spread
  552.         Unzip.....................c:\lotus\spread\123sprd.zip
  553.         Will result in............c:\lotus\spread\*.* (all files)
  554.     
  555.       Restore Directory Structure example:
  556.         Working directory.........c:\lotus
  557.         Unzip.....................c:\lotus\123sprd.zip
  558.           Containing..............*.*   spread1/*.*   spread2/*.*
  559.         Will result in............c:\lotus\*.*
  560.         ..........................c:\lotus\spread1\*.*
  561.         ..........................c:\lotus\spread2\*.*
  562.     
  563.     
  564.     
  565.     
  566.     
  567.     
  568.     
  569.     
  570.     
  571.     
  572.     
  573.     
  574.     
  575.     
  576.     
  577.     
  578.     
  579.     
  580.     
  581.                                     - 9 -
  582.     
  583.     ─────────────────────────────────────────────────────────────────
  584.     REGISTRATION FORM
  585.     
  586.     Mail your check along with this form to:
  587.     
  588.               Stanley May
  589.               916B Kirsten Court
  590.               Rohnert Park, CA 94928
  591.     
  592.     
  593.     
  594.     Company:
  595.              ───────────────────────────────────────
  596.     
  597.        Name:
  598.              ───────────────────────────────────────
  599.     
  600.     Address:
  601.              ───────────────────────────────────────
  602.     
  603.     
  604.              ───────────────────────────────────────
  605.     
  606.        City:                    State:      Zip:
  607.              ──────────────────        ────      ────────
  608.     
  609.       Phone: (      )        ─
  610.               ─────   ──────   ─────────
  611.     
  612.     
  613.     ZFace version you are currently using:
  614.                                            ──────
  615.     
  616.     
  617.     
  618.     Number of copies     @ $25.00 ea........$           .
  619.                      ───                     ──────────   ─────
  620.     
  621.     All funds must be in US Dollars, personal and company checks
  622.     accepted. All checks must be drawn against a US Bank and payable
  623.     in US Dollars.
  624.     
  625.     Sorry, no credit cards.
  626.     
  627.     ─────────────────────────────────────────────────────────────────
  628.     
  629.                                   <END>
  630.     
  631.     
  632.     
  633.     
  634.     
  635.     
  636.     
  637.     
  638.     
  639.     
  640.                                    - 10 -
  641.     
  642.